home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_100 / 144_01 / sort.hlp < prev    next >
Text File  |  1985-08-19  |  2KB  |  52 lines
  1. **********************************************************************
  2. *                               SORT                                 *
  3. **********************************************************************
  4. *                  COPYRIGHT 1983 EUGENE H. MALLORY                  *
  5. **********************************************************************
  6. PROGRAM:
  7.     SORT - Sorts a file on a specified key
  8. USAGE:
  9.     SORT [<fid] [-R] [-U] [-Cn] [-Ln] [-H] [>fid]
  10. FUNCTION:
  11.     This program does an internal sort of up to 512 entries.
  12.     Input and output are the standard redirectable input and
  13.     output.  Options include:
  14.     
  15.     -R   Reverse order sort.
  16.     -U   Convert to upper case before comparing.
  17.     -Cn  First column to begin compare. 1 is default.
  18.          It is ok to specify a position longer than some
  19.          lines.  Lines shorter will compare as equal.
  20.     -Ln  Length of field to compare.  Full line length is default.
  21.     -H   Display the available options.
  22.     
  23. EXAMPLE:
  24.     SORT <A -C10 -L10 -R
  25.     WORDS <FILE |SORT |UNIQUE -N |SORT    {Gives word list by frequency.)
  26. COMMENTS:
  27.     This is an internal sort which uses the available space in memory.
  28.     If the input file is too big, an out of space error will be given.
  29.     
  30.     The sort is "stable" and it is possible to sort on a less 
  31.     significant field first and a more significant field second.
  32.     Cascading sorts in this way can give sorts on complicated keys
  33.     with some descending and some ascending.
  34.     
  35.  
  36.  
  37.         Command Line                       
  38.  
  39. ___________________________________  
  40.                                   |  
  41.                                   |  
  42.                                   |  OPTIONS
  43.                                   |  
  44.                                   |                  
  45.                     ______________V______________    
  46.  Standard Input     |                           |   Standard Output
  47.      TEXT           |                           |     SORTED TEXT
  48. ------------------->|            SORT           |----------------------->
  49.                     |                           |
  50.                     |                           |
  51.                     |___________________________|
  52.